home *** CD-ROM | disk | FTP | other *** search
-
-
-
- hp2xx(1) USER COMMANDS hp2xx(1)
-
-
-
- NAME
- hp2xx - A HPGL converter into some vector- and raster for-
- mats
-
- USAGE
- hp2xx [-options] [hpgl-file(s)]
-
- OPTION SUMMARY
- Option Format Default Description
- -------------------------------------------------------------------------
- General options:
- -f char * "" Name of output file (default: stdout)
- -m char * pcl Mode. Valid: mf,ps, pcl,pcx,atari, vga (DOS only)
- -p int 1 Pensize [dots] (PCL,PCX,VGA), [1/10 mm] (mf, ps).
- Valid: 1-4
- -q off Quiet mode. No diagnostic output.
- -r double 0.0 Rotation angle [deg]. -r90 gives landscape
- -s char * hp2xx.swp Name of swap file
-
- Size controls:
- -a double 1.0 Aspect factor. Valid: > 0.0
- -h double 100 Height [mm] of picture
- -w double - Width [mm] of picture. If given, overrides -h
- -x double - Preset xmin value of HPGL coordinate range
- -X double - Preset xmax value of HPGL coordinate range
- -y double - Preset ymin value of HPGL coordinate range
- -Y double - Preset ymax value of HPGL coordinate range
-
- Raster format controls:
- -d int 75 DPI value (x or both x&y)
- -D int 75 DPI value (y only)
-
- PCL only:
- -F off Send a FormFeed after graphics data
- -i off Pre-initialize printer
- -S off Use (Deskjet) Special commands
- -o double 0.0 x offset [mm] of picture (left margin)
- -O double 0.0 y offset [mm] of picture (upper margin)
- -d (see above) Valid ONLY 300, 150, 100, 75
- -D (see above) INVALID for PCL!
-
- PS and PCL:
- -o double 0.0 x offset [mm] of picture (left margin)
- -O double 0.0 y offset [mm] of picture (upper margin)
-
- VGA (on PCs) only: Hi-Res mode setups:
- -V int 18 VGA mode byte (decimal)
- -W int 640 VGA pixel width.
- -------------------------------------------------------------------------
- -H Show help.
-
-
-
-
-
- Sun Release 4.1 Last change: 12 September 1991 1
-
-
-
-
-
-
- hp2xx(1) USER COMMANDS hp2xx(1)
-
-
-
- DESCRIPTION
- _h_p_2_x_x reads HPGL ASCII source files, interprets them, and
- converts them into either another vector-oriented format or
- one of several rasterfile formats. Currently, its HPGL
- parser only recognizes a small subset of the HP 7475 command
- subset, basically the absolute or relative Move or Draw com-
- mands, so don't expect fancier stuff like circles / text
- output / filled polygons. Since it only processes simple
- vectors, its output can be easily adapted to many formats.
-
- GENERAL FUNCTION
- _h_p_2_x_x reads from stdin or from a file if any given on the
- command line. You may specify more than one input file (if
- this makes sense at all). The output is written to stdout by
- default. Use option -_f _o_u_t_f_i_l_e to specify your output file
- name, or just use output redirection (DOS users beware: DOS
- limits output redirection to ASCII data only, so -f is pre-
- ferred). The program scans the current HPGL source, writes
- all vectors in internal binary format into a temporary file,
- and concurrently determines the maximal coordinate range. It
- then processes the vectors by mapping them into a new coor-
- dinate system with a height of 100mm by default exactly cov-
- ering the detected y range, and by preserving the aspect
- ratio of the original data. Use option -_h _h_e_i_g_h_t to set the
- desired height of your output picture; optionally use -_a
- _a_s_p_e_c_t_f_a_c_t_o_r to alter the aspect ratio by the given factor
- (aspectfactor < 1 narrows your picture). Alternatively,
- specify the desired picture width using -_w _w_i_d_t_h. The height
- will then be automatically generated, as will be the width
- if you control the picture's heigth. Please note that -_w
- overrides any -_h option!
-
- Option -_r _r_o_t_a_t_i_o_n__a_n_g_l_e (_i_n _d_e_g_r_e_e_s) allows you to rotate
- the object prior to all scaling operations. Its main use is
- to facilitate landscape format: -r90 rotates your whole pic-
- ture, e.g. from portait to landscape format. However, any
- reasonable rotation angle is valid.
-
- If you need to process a series of similar objects which
- should be translated into exactly the same coordinate sys-
- tem, there is a way to override the auto-scaling: First, run
- all files separately and note the infos on the used coordi-
- nate ranges. Then, pick a range that will cover ALL your
- pictures. You can now assign defaults to the internally
- generated range limits by specifying -_x _x_m_i_n, -_X _x_m_a_x, -_y
- _y_m_i_n, and -_Y _y_m_a_x. NOTE: Clipping is NOT supported! If any
- picture coordinate exceeds your limits, they will be
- overwritten.
-
- Use option -_m _m_o_d_e to select the program mode, i.e. the out-
- put format. Currently supported: mode = "mf" (Metafont),
- "ps" (PostScript), "pcl" (HP-PCL Level 3 format, suitable
-
-
-
- Sun Release 4.1 Last change: 12 September 1991 2
-
-
-
-
-
-
- hp2xx(1) USER COMMANDS hp2xx(1)
-
-
-
- for printing on a HP Laserjet II, DeskJet, or compatible
- printer), "atari" (ATARI screen format), or "pcx" (PC-
- Paintbrush format, also accepted by MS-Paintbrush / Windows
- 3.0 and many other PC based pixel renderers). On PC's, there
- also is a preview option "vga" which supports VGA cards
- ONLY. Default mode is pcl.
-
- If you use a raster format, the picture is rasterized by
- default into a 75 DPI resolution image. Use option -_d
- _D_P_I__v_a_l_u_e to change the resolution, e.g. -d300 will cause a
- HP LJ-II compatible 300 dpi rasterization. There is a way of
- specifying a different resolution for y direction: -_D
- _D_P_I__y__v_a_l_u_e, although it is of limited use yet. It is
- intended for, e.g., support of NEC P6 printers (360x180 DPI)
- and alike in a later release.
-
- If processing large pictures at high resolution on low-
- memory machines, typically under DOS, the program may start
- swapping. Opionally change the swap file by using -_s _s_w_a_p_-
- _f_i_l_e, e.g. to speed up processing by swapping to a RAM disk.
-
- VECTOR FORMATS
- Currently, two vector formats are supported: _T_e_X/_M_e_t_a_f_o_n_t
- and -I PostScript. Use -_m _m_f to convert a HPGL drawing into
- a Metafont character to be included into a TeX document as
- the character "Z" of a special font that you may create.
- Edit the metafont source, e.g., to change the letter "Z" for
- another, or to change the line thickness, which is set to
- 0.4pt by default. Use option -_p _p_e_n_s_i_z_e for a limited con-
- trol over pensize: The actual Metafont pensize will be "pen-
- size * 0.1 mm", with pensize = 1, 2, 3, or 4. The same
- applies to -_m _p_s, the PostScript mode. Here, you also need
- to use options -o and -O (see below) for proper margins in
- paper since _h_p_2_x_x puts your picture "flush" to the left and
- upper paper limit by default.
-
- RASTER FORMATS
- The following formats are supported: HP-PCL, PCX, ATARI, and
- VGA (preview on PC's). However, generation of other formats
- is made easy for programmers because of _h_p_2_x_x'_s modular
- structure. The program allocates a bitmap on a line-by-line
- basis, swapping lines to disk if needed, and plots into this
- bitmap. Depending on the selected format, a conversion
- module is then activated, which might easily be replaced by
- other converters. Add more formats if you like!
-
- Option -_p _p_e_n_s_i_z_e controls the size (in pixels) of the vir-
- tual plotting pen. The only implemented shape of the pen tip
- is a square of the given length. Default pen size is 1.
- Specifying -p4 when in 75 DPI mode will make pretty clumsy
- pictures, while you may prefer -p2 over -p1 when in 300 DPI.
-
-
-
-
- Sun Release 4.1 Last change: 12 September 1991 3
-
-
-
-
-
-
- hp2xx(1) USER COMMANDS hp2xx(1)
-
-
-
- PCX: The size of a PCX picture is controlled via its speci-
- fied height and the current DPI value. To create a high-
- resolution PCX image, just increase the DPI value as
- desired. PCX format does not accept offsets.
-
- ATARI: ST screens (640x400 pixels) can easily be dumped to
- files. Many programs accept graphics by including these
- screen dump files. Graphics filling more than one screenful
- may be split into screen-size blocks and loaded/mounted
- blockwise. _h_p_2_x_x converts to ATARI screen format by trying
- to fit the resulting picture into a single screen equivalent
- (max. 400 rows, max. 80 Bytes (640 pixel) per row). If it
- succeeds, _h_p_2_x_x produces a single output file. Specify ONLY
- its base name (option -f), since _h_p_2_x_x adds the file exten-
- sion ".000". However, if more screen blocks are required
- horizontally and/or vertically, _h_p_2_x_x will automatically
- split the picture into files with extensions ".001" / ".010"
- to a maximum of ".999" in a matrix-like fashion: Extension
- ".rrc" indicates a block at row position rr and column posi-
- tion c, counting from 0. The picture is padded with back-
- ground color at its right and lower margins, if needed. File
- compression is not supported yet. -- By setting DPI and
- height/width, you implicitely have control over the result-
- ing scan lines or columns. E.g., leaving DPI at its default
- (-d 75), and specifying a height of 135mm (-h 135), you'll
- get 400 rows.
-
- PCL: HP-PCL Level 3 format, most useful for direct printer
- output. Due to this action, there have been added some extra
- flags and options: Use flag -_i to send a printer initializa-
- tion sequence before the actual image. Flag -_F adds a Form
- Feed (FF, hex 0C) after the image is completed, which is
- what you may want most of the time. However, overlay print-
- ing of several files is feasible by omitting -F.
-
- For additional control of the picture's final position on
- paper, you may add x or y offsets using -_o _X__o_f_f_s_e_t or -_O
- _Y__o_f_f_s_e_t. _E._g., -_o _2_0 -_O and 20 mm additional left margin.
-
- For DeskJet / DeskJet-plus / DeskJet 500 printers, there are
- some special printer commands. Activate them with flag -_S.
-
- EXAMPLES
- % hp2xx -m pcx -f my_output.pcx -d300 -p2 -h50 -a 1.2 my_input.hp
-
- creates a PCX file at 300 DPI of height 50 mm, using an
- aspect factor of 1.2 and a pen size of 2 pixels.
-
- % my_hpgl_generator | hp2xx -o20 -O30 -F -q | lpr -P my_PCL_printer
-
- HPGL output is piped through hp2xx; the resulting PCL code
- is piped to the printer queue, giving an image of height 100 mm
-
-
-
- Sun Release 4.1 Last change: 12 September 1991 4
-
-
-
-
-
-
- hp2xx(1) USER COMMANDS hp2xx(1)
-
-
-
- at 75 DPI. An additional left margin of 20mm and upper margin
- of 30mm is created. A formfeed will be added (handy if your
- printer queue does not).
-
- % hp2xx -m vga my_input.hp
-
- (PC only): Preview on VGA screen.
-
- AUTHOR
- Heinz W. Werntges, Biokybernetik, Geb. 26.12, Heinrich-
- Heine-Universitaet,
- D-4000 Duesseldorf 1, Germany. Internet: heinz@biokyb.uni-
- duesseldorf.de
-
- DIAGNOSTICS
- The number of ignored and/or unknown HPGL commands is given.
- You will be informed if swapping starts. Progress is indi-
- cated by output of dots, each dot representing 10 move/draw
- commands during scanning and plotting, or 10 scan lines dur-
- ing output. Shut off diagnostic output by specifying -_q
- (quiet mode).
-
- BUGS
- There are many non-implemented HPGL commands. Only few test-
- ing has been done for Postscript and ATARI formats, so be
- prepared for bugs there, and PLEASE report them -- thank
- you!
-
- SEE ALSO
- HPtoMF(1), D. Donath's HPGL-to-Metafont converter.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Sun Release 4.1 Last change: 12 September 1991 5
-
-
-
-